home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / rcmplb30.zip / RCMPLIB.DOC < prev    next >
Text File  |  1994-02-20  |  10KB  |  273 lines
  1. ┌─────────────────────────────────────────────────────────────────────────╖
  2. │                                                                         ║
  3. │                       RCmpLib  version 3.0 (20/02/94)                   ║
  4. │                                                                         ║
  5. │                                                                         ║
  6. │        (c) 1994  Rolf van Gelder, EINDHOVEN - All rights reserved       ║
  7. │                                                                         ║
  8. ╘═════════════════════════════════════════════════════════════════════════╝
  9.  
  10.  
  11.  
  12. 1     INTRODUCTION --------------------------------------------------------
  13.  
  14.       RCmpLib is a CA-CLIPPER LIBRARY with data compression functions.
  15.  
  16.       Because RCmpLib is partially written in ASSEMBLER its functions are
  17.       VERY FAST !
  18.  
  19.       Two libraries are enclosed :
  20.  
  21.       RCmpLib.lib - Library for CA-Clipper version 5.xx
  22.       RCmpS87.lib - Library for Nantucket Clipper Summer '87
  23.  
  24.       RCmpLib is a Shareware product :
  25.  
  26.       You have the opportunity to try the program 30 days at no charge
  27.       to see if it meets your needs.
  28.       If you continue to use the program after evaluation,
  29.       please complete the included registration form (RCmpLib.REG,
  30.       for DUTCH users Dutch.REG) and send it with the applicable
  31.       registration fee to the author.
  32.  
  33.  
  34.       FEATURES :
  35.  
  36.       *    COMPRESSION of MULTIPLE FILES into one ARCHIVE FILE
  37.            (Optional DELETION of FILES after COMPRESSION)
  38.  
  39.       *    EXTRACTION of ONE OR MORE FILES from an ARCHIVE FILE
  40.  
  41.       *    OPTIONAL DISPLAY of PROGRESSION BARS during COMPRESSION and
  42.            DECOMPRESSION of FILES
  43.  
  44.       *    USER INTERRUPTABLE COMPRESSION/DECOMPRESSION
  45.  
  46.       *    FUNCTIONS TO COMPRESS & DECOMPRESS STRINGS and MEMO-FIELDS
  47.  
  48.       *    OPTIONAL PASSWORD ENCRYPTION of COMPRESSED FILES and STRINGS
  49.  
  50.       *    IMPROVED MEMORY MANAGEMENT
  51.            (Consumes ca. 16Kb less base memory than previous versions !)
  52.  
  53.       *    FAST & RELIABLE COMPRESSION with a GOOD COMPRESSION FACTOR
  54.  
  55.       *    A NORTON GUIDE with a description of all functions in the library
  56.  
  57.       *    EXOSPACE COMPATIBLE
  58.  
  59.       *    CA-CLIPPER 5.XX DEMO PROGRAM with EXAMPLES
  60.  
  61.       *    NANTUCKET CLIPPER SUMMER '87 DEMO PROGRAM with EXAMPLES
  62.  
  63.  
  64.  
  65. 2     COMPRESSION AND DECOMPRESSION ---------------------------------------
  66.  
  67.  
  68. 2.1   COMPRESSION ALGORITHM -----------------------------------------------
  69.  
  70.       The compression and decompression functions of RCmpLib are based on
  71.       the so-called Lempel-Ziv principle, to be specific the LZW algorithm.
  72.       This base principle is used by almost all famous compression programs
  73.       (as LHARC, ARJ and PKZIP).
  74.  
  75.       The principle works in short as follows :
  76.       (Sub-)Strings that appear often in the file to compress are being
  77.       replaced by numerical codes.
  78.  
  79.       While decompressing, these codes are replaced again by the original
  80.       strings.
  81.  
  82.  
  83. 2.2   THE USE OF COMPRESSION IN CLIPPER APPLICATIONS ----------------------
  84.  
  85.       FILE COMPRESSION
  86.  
  87.       The most common use of compression function in Clipper applications
  88.       is the following scenario :
  89.  
  90.       Decompress all Clipper data files (.DBF,.DBT,.NTX,.FRM,... etc.) at
  91.       the beginning of an application. While the application is running
  92.       all the files are accessible in their normal, uncompressed form.
  93.  
  94.       Compress all the Clipper data files (.DBF,.DBT,.NTX,.FRM,... etc.)
  95.       at the termination of the application.
  96.  
  97.       Advantages of this method :
  98.  
  99.       - During the execution of the application all is normal
  100.         (all the files are uncompressed on the disk)
  101.  
  102.       - After the termination of the program, the application will consume
  103.         much less disk space (the data files are compressed)
  104.  
  105.       - Backups of the application consume much less floppy disk space
  106.         (data files are backupped in their compressed form)
  107.  
  108.       - One of the greatest advantages is :
  109.         After the application is terminated all data files will be
  110.         UNACCESSIBLE to the user (or other persons).
  111.  
  112.         A compressed file is UNREADABLE !!
  113.  
  114.         Files with secret information can't be examined using an editor
  115.         or list program. 
  116.         It will be IMPOSSIBLE to manipulate the files with for example
  117.         dBASE or any other .DBF viewer/editor :
  118.         The (compressed) database can't be corrupted doing that way.
  119.  
  120.         If you want to prevent that an other RCmpLib user can decompress
  121.         the files you can protect your archive using the PASSWORD option.
  122.  
  123.  
  124.       STRING COMPRESSION
  125.  
  126.       With RCmpLib v3.0 it is also possible to compress memo-fields !
  127.  
  128.       If you are compressing existing memo-fields of a database the size
  129.       of the .DBT file will not immediately decrease ...
  130.       You have to reorganize (only the first time) the memo file to see
  131.       the result.
  132.  
  133.       One method for reorganizing is the following :
  134.       1) Copy the .DBF and the .DBT files to temporary files
  135.       2) Zap the original files
  136.       3) Append all the records from the temporary files
  137.       4) Delete the temporary files
  138.  
  139.  
  140. 2.3   QUALITY OF THE COMPRESSION ------------------------------------------
  141.  
  142.       The compression method used by RCmpLib is fast, reliable and gives
  143.       a good compression factor.
  144.  
  145.       In comparison with the commercial compression programs as PKZIP 2.04
  146.       and ARJ 2.41, RCmpLib will score a little less.
  147.  
  148.       The comparison is not completely fair because PKZIP and ARJ standalone
  149.       programs are with only one goal : compression.
  150.       RCmpLib is a part of a complete Clipper application and has to deal
  151.       with less resources (as memory).
  152.  
  153.  
  154.  
  155. 3     FUNCTIONS IN RCMPLIB ------------------------------------------------
  156.  
  157.       A complete, detailed description of the functions (with examples)
  158.       can be found in the Norton Guide (RCmpLib.NG).
  159.       Both a Clipper 5.xx and a Summer '87 version of the functions is
  160.       described in the Guide.
  161.  
  162.  
  163.  
  164. 4     REGISTRATION --------------------------------------------------------
  165.  
  166.       RCmpLib is a SHAREWARE product. It is available world-wide through
  167.       Users Groups, Bulletin Boards, FTP-Servers, etc.
  168.  
  169.       You have the opportunity to try the program 30 days at no charge,
  170.       to see if it meets your needs.
  171.       If you continue to use the program after evaluation, please complete
  172.       the included registration form (RCmpLib.REG, for DUTCH users Dutch.REG)
  173.       and send it to:
  174.  
  175.                       ┌────────────────────────╖
  176.                       │ Ing. R.P.B. van Gelder ║
  177.                       │ Binnenwiertzstraat 27  ║
  178.                       │ 5615 HG  EINDHOVEN     ║
  179.                       │ THE NETHERLANDS        ║
  180.                       ╘════════════════════════╝
  181.  
  182.  
  183.       REGISTRATION FEE 
  184.  
  185.       If you are a NEW RCMPLIB USER, the registration fee is :
  186.  
  187.             DELIVERY BY E-MAIL : US $ 25
  188.             DELIVERY BY POST   : US $ 30
  189.  
  190.  
  191.       UPGRADE OFFER 
  192.  
  193.       If you already are a REGISTERED USER of RCmpLib,
  194.       the upgrade costs are :
  195.  
  196.             DELIVERY BY E-MAIL : US $ 10
  197.             DELIVERY BY POST   : US $ 15
  198.  
  199.  
  200.       PAYMENT 
  201.  
  202.       Just include the appropriate amount of money (IN CASH !!) with the
  203.       registration form (RCmpLib.REG, for DUTCH users Dutch.REG)
  204.       and send it to the address as mentioned above.
  205.  
  206.       ┌────────────────────────────────────────────────────────────────╖
  207.       │                        -+- IMPORTANT -+-                       ║
  208.       │                                                                ║
  209.       │ NORMALLY I DON'T ACCEPT ANY FOREIGN BANK CHECK, MONEY ORDERS   ║
  210.       │ NOR CREDIT CARDS. BECAUSE IF I REMIT THE MONEY TO MY DUTCH     ║
  211.       │ ACCOUNT, THE BANK WILL CHARGE ME $ 10 US (!) FOR TRANSFER      ║
  212.       │ COSTS !!!  I AM VERY SORRY FOR THAT ...                        ║
  213.       │                                                                ║
  214.       │ HOWEVER, IF